<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ctdb-etcd</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="ctdb-etcd.7"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ctdb-etcd &#8212; CTDB etcd integration</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">ctdb_etcd_lock</code> </p></div></div><div class="refsect1"><a name="idm24"></a><h2>DESCRIPTION</h2><p>
      ctdb_etcd_lock is intended to be run as a mutex helper for CTDB. It
      will try to connect to an existing etcd cluster and grab a lock in that
      cluster to function as CTDB's cluster lock. Please see
      <span class="emphasis"><em>ctdb/doc/cluster_mutex_helper.txt</em></span> for details on
      the mutex helper API. To use this, include the following line in
      the <code class="literal">[cluster]</code> section of
      <span class="citerefentry"><span class="refentrytitle">ctdb.conf</span>(5)</span>:
    </p><pre class="screen">
cluster lock = !/usr/local/usr/libexec/ctdb/ctdb_etcd_lock
    </pre><p>
      You can also pass "-v", "-vv", or "-vvv" to include verbose output in
      the CTDB log. Additional "v"s indicate increases in verbosity.
    </p><p>
      This mutex helper expects the system Python interpreter to have access
      to the etcd Python module. It also expects an etcd cluster to be
      configured and running. To integrate with this, there is an optional
      config file of the following format:
    </p><pre class="screen">
key = value
    </pre><p>
      The following configuration parameters (and their defaults) are defined
      for use by ctdb_etcd_lock:
    </p><pre class="screen">
port      = 2379   # connecting port for the etcd cluster
lock_ttl  = 9      # seconds for TTL
refresh   = 2      # seconds between attempts to maintain lock
locks_dir = _ctdb  # where to store CTDB locks in etcd
                   # The final etcd directory for any given lock looks like:
                   #   /_locks/{locks_dir}/{netbios name}/
    </pre><p>
      In addition, any keyword parameter that can be used to configure an
      etcd client may be specified and modified here. For more documentation
      on these parameters, see here: https://github.com/jplana/python-etcd/
    </p></div><div class="refsect1"><a name="idm39"></a><h2>SEE ALSO</h2><p>
      <span class="citerefentry"><span class="refentrytitle">ctdb</span>(7)</span>,

      <span class="citerefentry"><span class="refentrytitle">ctdbd</span>(1)</span>,

      <a class="ulink" href="http://ctdb.samba.org/" target="_top">http://ctdb.samba.org/</a>
    </p></div></div></body></html>
